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About NetYaroze 


What You Need to Know 

In order to get started with NetYaroze, you should have experience ofC programming to a competent level 
and a knowledge of a 2D graphic creation/editing tool. In addition, at least a basic grasp of a 3D modelling 
packageand a sound creation/editing toolwould be help you get the best out of you Neff aroze kit. 

The NetYaroze Manual Set 

There are three books in the set of NetYaroze manuals. 

• Start Up Guide (this document) 

An introductory booklet explaining the contents and requirements of the NeY aroze Starter Kit. It 
also gives step by step instructions on setting up they Neff aroze software on your PC and how to run 
Net Yaroze software on the system. 

• User Guide 

A reference manual providing details on making software for the NeY aroze system. 

• Library Reference 

A manual listing and describing the functions and structures in the NeYaroze libraries. 

Additional Reading 

See Additional Reading at the back of this manual. 





Introduction 


The Net Yaroze Starter Kit is an integrated environment for developing PlayStation software on your personal 
computer. Work developed on a PC can be played by downloading to a specialPlay Station, available only to 
Members of Net Yaroze. 

Members can then share their creations and knowledge with otherMembers via a unique Members only Web 
site server provided by Sony Computer Entertainment 





Members OnlyWeb Site 


Connection to the Members OnlyWeb Site 

Members are provided with access to one of three Neff aroze servers, the URL being: 
http://www.scei. co.jp/Net/ for Members in Japan 

http://www.scee. sony.co.ukyaroze/ for Members in Europe 

http://www.sony.com/faroze/ for Members in North America 

Software Necessary for Connection 

We recommend Netscape version 2.0 or later as the browser software necessary for connection to the Members 
onlyWeb site. 

ID and Password 

The ID and password for access to the Memberstnly Web site will be provided with yourWelcome Pack 

Being a Member of Netfaroze 

A key part of Net Yaroze is the activity of its Members on their Web site. As well as sharing work that you 
have developed and enjoying the creations of otherMembers, the Members only Web site will offer a range of 
other activities. 

Further Information- Support 

Sony Computer Entertainment also use the Members only Web site to provide additional technical information 
or data that is not included in the documentation Please ask for information that is not provided. 





Contents of the Package 


The following items are included in theNet Yaroze package: 


1. DTL-H3001 NetYaroze Member's PlayStation or 
DTLH-3002 NetYaroze Member's PlayStation 

(Power cable and AV (RFU) cable included) 

2. DTL-H301 ((Controllers x 2 

3. DTL-H3020Access card 

4. DTL-S3035 NetYaroze boot disk 

5. DTL-S3045 NetYaroze software development disk 

6. DTL-H3050Communications cable 

7. DTL-D3065 Start Up Guide (this manual) 

8. DTL-D3075 User Guide 

9. DTL-D3095 Library Reference 


Notes 

Please note that the model numbers of the package you receive may vary slightly depending on which of the 
three Net Yaroze Members' regions that you live in. 

'NetYaroze' is the registered trademark of the project. However, it is also referred to aY'aroze'. 





Operating Environment 


You need the following hardware and softwarein order to use the Net Yaroze development environment 


Hardware 

A DOS/V compatible PC/AT with a 486DX2 66MHz CPU (fester 

It should have one or more serial ports, and a modem (at least a 14,400bps modem) for connection to the 
Yaroze Web site 


• Hard Disk 

At least 10MB of free disk space in order to set up the basic development environment 

• Memory 
At least 4MB RAM 

• CD-ROM Drive 

• Display 

For the PC SVGA monitor 

For the PlayStation A standard TV monitor with a video input terminal 

(ideally with multi format capabilities) 

• Mouse 
Software 

MS-DOS Version 5.0 or later 


Windows 3.1 orWindows95 





Set Up 


Hardware Connection 

Make sure that the PC and Net Yaroze PlayStation power switches are turned off After connecting the serial 
port of the PC and the PlayStation with the communication cable, as shown in the diagram below, place the 
Access card in the PlayStation's Memory card slot 1. 

Next, connect the PlayStation to the TV monitor with the supplied AV cable. 

In order to access the Net Yaroze Members only Web site via the Internet, you need a separate modem and 
telephone line connection, a contract with an Internet service provider and an IntemetWeb browser installed 
on your PC. 


YAROZE Members’ 







Software Set Up 


For the PlayStation 

No special set up operation is necessary. The integrated environment is loaded automatically whenyou put the 
Net Yaroze boot disk in the Net Yaroze PlayStation, the access card in Memory card slot 1 and switch the 
power on. The following screenis displayed on the TV monitor. 


For the PC 


F older Copy 

Place the enclosed Net Yaroze software development disc (hereafter 'CD-ROM') in the PC CD-ROM drive and 
copy the contents of each folder to the hard disk using a DOS XCOPY or Windows Program 
Manager/Explorer. (At the root of CD-ROM there are two folders called PSX and GNU. You can copy these 
folders anywhere on the hard disk.) In the example below, the PSX and GNU folders are copied onto the C 
drive root. 

Rewritingconfig.sys 

Check the contents of config.sys in the root of c drive and confirm whether or not ansi.sys is included. If it is 
not included, add the following line and reboot the system. 

devicehigh=C: \WINDOWS\ ansi . sys 


Rewriting the Batch F ile 

There is a file called djsetup.bat in the PSX folder which you have copied to the hard disk. Its contents are as 
follows. 


©echo off 

set DJGPP=c : /psx/dj gpp . env 

PATH %path%;c:\psx\bin;c: \gnu\bin 

set TMP=c:\tmp 

set DTLH3000=0x3f 8 ,4,9600 

If the psx and gnu folders are not on c drive root, amend this file so the contents correspond to the location and 
names (if you have changed these) of the copied folders. This procedure is described below. 



Note 


Because the file is copiedrom the CD-ROM, thcfile is read only. Before editingphange this in DOS as blow. 
C:\PSX> attrUb -r dj setup .bat (where'c:\PSX is the path) 


• The second line is the set up of the environment variable DJGPP. The compiler's environment setting 
file is specified. If appropriate, modify the c:/psx part so it refers to the correct path and name of the 
copied folder. Note that you must use a T (forward slash) to delimit the path for this environment 
variable only. 

• The third line is the setting of the environment variable PATH. Rewrite thec:\psx and c:\gnu part to 
the name and path of the copied folde? if appropriate. 

• The fourth line is the working folder. Create and allocate a folder if c:/tmp is not appropriate. 
For example, change the line to: 

set tmp=c : \yaroze\wrk (where'wrk' is your preferred working folder) 

• The fifth line is the setting relating to communication with the NetYaroze PlayStation. Specify the 
port address, IRQ and speed (in this order) separated by the defaults, OX3F8 and IRQ4, are the 
general address and IRQ of COM1. 

• Specify 0X2F8 as the address and IRQ3 if you use COM2. 

• Communication speeds ofup to 115200bps are supported. Specify either 9600, 19200, 38400, 57600 
or 1 15200 according to the processing capacity of your PC. 

• (Please note that if you wish to use speeds other than 9600 baud, you should place a standard 
formatted PlayStation Memory card in your Net Yaroze PlayStation's Memory card Slot 2 and change 
the rate using SIOCONS- See chapter 17of the Net YarozeUser Guidefor details of SIOCONS) 





Execution of the Environment Setting Batch F ile 

From the PSX folder (or your chosen folder name) in DOS (or the DOS box from Windows) execute the 
rewritten batch filedjsetup.bat, as below. 

C : \ PSX>dj setup (where 'PSX 1 is your chosen folder name) 

This completes the preparation of the development environment 




Getting Started 


There are some sample and quick start programs which you can use to test you NetYaroze system set up and 
get started on compiling and running some programs. 

Programmers with a lot of experience, may wish to go straight to theSample Program section of this chapter, 
which skips a lot of explanation. The Quick Start section covers the same process, but gives a little more 
detail as it steps through NetYaroze software development. 

Quick Start 

The 'quick' directory on the NetYaroze PC CD holds some quick start test programs. You probably copied it 
to your PC's hard disk together with all the NeiY aroze software. 

Using the quick start programs you can quickly check that everything is working on your NYtaroze system. 

Net Yaroze Program Development - Overview 

Here are the basic steps that you need to take to develop software on the NetYaroze system. (See the Net 
Yaroze User Guide chapter 13for more details on the development cycle.) 

1. Create/edit text files which contain the C code. 

Also known as the 'source code', these are usually namedihme.c' (where 'name' is the selected file 
name). 

(There are two source code files already in the quick directory: tutoO.c and tutol.c.) 

2. Compile and link the C files to crate the executable file (the file that is the finished 
program/application). 

(In the test example, below, we use amakefile, called by the command 'make' to do this.) 

3. Use the SIOCONS console tool, provided as part of your Ndf aroze software, to establish contact 
between your NetYaroze PlayStation and PC. 

4. Run the executable program. 




5. (In this test example, there are two batch files - batchO and batchl - which you can use to ran the 
executable files (or 'executables') of the test programs.) 

Compile and Run the Quick Start Programs - Step by Step 

1. Set up your NetYaroze PlayStation as described in theStart Up Guide link the Net Yaroze 
PlayStation to your TV and PC, and insert a Controller in thiPlay Station's Controller port 1 . 

2. Turn on the PC, TV and NetYaroze PlayStation and wait for the ready-to-go screen to appear on the 
TV, as shown below. 
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This screen should appear within 30 seconds of turning on or resetting the NeYaroze PlayStation, after the 
Sony and PlayStation logo screens. 


1 . On the PC, bring up an MS-DOS box and, from the PSX folder (or your chosen NMaroze folder 
name), invoke the NetYaroze environment setting batch file as follows: 

c: \PSX>djsetup (where 'PSX' is your chosen Neff aroze folder name) 

2. Compile the quick start programs. Use the 'make' utility to do this by typing 'make' to the DOS 
prompt to create the executable programs from the source files. 

c : \psx\quick>make 

3. Bring up the console tool, SIOCONS.(You must have set up the quick directory as a path for 
SIOCONS in yourautoexec.bat file.) 

c : \psx\quick>siocons 

or, if you have already changed the baud rate, type 

c : \psx\quick>sicons -B<baud rate> (where '<baud rate>' is the value of your chosen 
rate) 

4. Now you are in SIOCONS, the console tool used to communicate with the NMaroze PlayStation 
from the PC. 

The PC monitor output should look similar to this: 


c : \psx\quick>siocons -B115200 

siocons — PlayStation debug system console prog 
for DTLH3000 1996/05/10 00:00:03 

type FI > display help 

when hung up try type ESC 

I/O addr = 0x03F8, IRQ=4 ( vect=0x000C, 825 9=2 0 ) 

BAUDRATE = 115200 

5. Check that SIOCONS is working correctly by pressing return: if all is well, the SIOCONS prompt 
will appear, which is a double-right arrow: » 



6 . 


Run the quick start batch files. 


First, press [F3] on the PC keyboard. This brings up thdYuto [ 1 ] : prompt. Then enter the name of 
the batch file;batchO. 

For example (after pressing, [F3] on the PC keyboard): 

Auto[l] : batchO 

BatchO downloads and runs tuto0.exe. 

7. Immediately after starting the dowioad, downloading messages appear on the PC monitor, similar 
to the following. 


tutoO 

. text] 

address : 8 01 00000-8 01 OOlef 

size : OOOlf 0 

OOOlfO: 

lsec 

tutoO 

. rdata ] 

address : 8 01 001 f 0-8 01 002 Of 

size : 000020 

000020: 

lsec 

tutoO 

. data] 

address : 8 01 0021 0-8 01 0035f 

size : 000150 

000150: 

2sec 

tutoO 

. sdata ] 

address : 8 01 00360-8 01 003df 

size : 000080 

000080: 

2sec 


8. The TV screen shows downloading messages, similar to those below: 

BINARY DATA TRANSFER - BWR 

ADRS = 80100000 

SIZE = 000001 FO BYTES 

INTO BURST TRANSFER SUM: 111F0/1F0 BYTES 
DONE. 

Running and Terminating a Program 

TutoO (called by batchO) prints 'Hello World!' to the SIOCONS console on the PC, and terminates 
automatically. 

When you have run and terminated a program, the NetYaroze PlayStation resets itself, going back to the 
ready-to-download screen (as shown in [2] ofCompile and Run the Test Programs - Step by Step, above, and 
SIOCONS displays its prompt again (»). 


Once the PlayStation and PC are reset, you can run the second quick start program, tutol, by following the 
steps described in [8] and [9] ofCompile and Run the Test Programs - Step by Stqpbove. 



Tutol (called by batch 1) prints 'Hello World!' to the TV screen. Terminate this program by pressing SELECT 
on the Controller. 

Exiting SIOCONS 

To quit SIOCONS and return to the MS-DOS prompt, on the PC keyboard, press [F 1 0] and then [F2],or just 
press [Esc]. 

Using the Test Files 

The source files, makefile and batch files are all simple text files which you can easily edit (Using the text 
editor in DOS, for example) to see their contents. 

To edit or look at the tutoO.c source code, using the text editor in DOS, type: 

c : \>psx\quick>textedit tutoO.c 

Look at the test and other sample code to familiarise yourself with what the NetYaroze system can do, and 
how to achieve this by writing C programs. 


Quick Directory Contents 


Type 

Name 

C files for the sample programs 

tutoO.c 

tuto 1 ,c 

pad.c 

Makefile 

makefile 

Batch files 

batchO (downloads and runs tutoO) 

batch 1 (downloads and runs tutol) 

Subdirectories 

make 

a help file on the program updating utility 'make' and some exampiakefiles 

batch 

a help file on batch 4utoexecution) files and some example batch files 

baudrate 

a help file on changing the baud rate (rate of data downloading from the PC) 






















Sample Program 

In order to check your environment, try downloading the sample program provided. (The source code and 
executable file are in thepsx\sample\check folder- where 'psx' is your chosen file name) 

Download the sample code as follows: 

1 . Execute Make 

Execute make at the DOS prompt to test the paths listed in djsetup.bat, and ensure that the program 
is compiled and linked correctly, as showrbelow (the text in bold indicates command line inpu). 

C: \PSX\SAMPLE\CHECK>maie 

gcc -01 -g -c main.c -o main.o 

gcc -Xlinker -Ttext -Xlinker 80140000 -o main main.o 

2. Run SIOCONS 

When the program is compiled and linked run the console monitor SIOCONSas shown below. 

C: \PSX\SAMPLE\CHECK>siocons 

siocons -- PlayStation debug system console program 
for DTLH3000 1996/05/10 00:00:00 

type FI > display help 

when hung up try type Ctrl+C 
I/O addr = 0x03F8, IRQ=4 ( vect=0x000C, 825 9=2 0 ) 

BAUDRATE = 9600 

3. Auto download 

Hit the F3 function key to obtain theAuto [ 1] prompt. Inputauto to indicate automatic download 
and press the enter key. (See below.) 



Auto [ 1 ] : auto 


main 

. text] 

address : 8014 0000-8014 0b4 f 

size: 000b50 

000b50 : 

lsec 

main 

. rdata ] 

address : 8014 0b50-8 014 0c7 f 

size : 000130 

000130: 

lsec 

main 

. data] 

address :80140c80-801412ef 

size : 00067 0 

000670: 

2sec 

main 

. sdata ] 

address : 8 01 4 12 f 0-8014137 f 

size : 000090 

000090: 

2sec 


PC=8014 0990, GP=801492f0, SP=801ffff0 


»go 

ResetGraph: j tb=8 004 7dd0, env=8 004 7el8 


With the operation so far, the sample program window should be displayed on the TV monitor screen. 
The Controller button operation is as follows. 


Up key 

Increases number of balls displayed 

Down key 

Decreases number of balls displayed 

LI button 

Display pause 

SELECT button 

Terminate 





Sample Program 


Sample Program Make File 

C FLAGS = -01 -g 

LINKER = -Xlinker -Ttext -Xlinker 80140000 
RM = del 

PROG = main 
OBJS = main.o 

all: $ ( PROG ) 

$ ( PROG) : $ (OBJS) 

$ ( CC ) $ (LINKER) -o $@ $? 

main.o: main.c 


$ ( RM ) $ ( PROG ) 
$ ( RM ) $ ( OBJS ) 


Sample Program Source List 

/* 

* Draw bouncing ball pattern on screen 

* Increase/decrease ball pattern number by up/down key 

* Read sound data from boot disk and play back as BGM 

* Copyright (C) 1996 Sony Computer Entertainment Inc. 

* All Rights Reserved 
*/ 


/* Preparation include header */ 
#include <libps.h> 




#include "pad.h' 


/* 

Macros 

*/ 

/* Basic setup */ 


#def ine 

KANJI 


/* 

Switch to display Kanji*/ 

#def ine 

OT LENGTH 

1 

/* 

Ordering table number*/ 

#def ine 

MAXOBJ 

1500 

/* 

Sprites (balls) maximum number*/ 

#def ine 

MVOL 

127 

/* 

Main volume level*/ 

#def ine 

SVOL 

127 

/* 

SEQ volume level*/ 

#def ine 

DFILE 

3 

/* 

File number*/ 

/* Macros relating 

to data arrangement 

*/ 

#def ine 

VH ADDR 

0x80090000 


#def ine 

VB ADDR 

0x800a0000 


#def ine 

SEQ ADDR 

0x80110000 



/* Macros relating 

to display area 

V 


#def ine 

FRAME X 

320 

/* 

Display area si ze ( hori zontal ) */ 

#def ine 

FRAME Y 

240 

/* 

Display area si ze ( vertical )* / 

#def ine 

WALL X 

(FRAME X-16) 

/* Ball pattern movement area size 
(horizontal) */ 

#def ine 

WALL Y 

(FRAME Y-16) 

/* 

Ball pattern movement area size 


(vertical) */ 

/* Range check macro */ 

#define limitRange ( x, 1, h) ( ( x ) = ( ( x ) < ( 1 ) ? ( 1 ) : ( x ) > ( h ) ? ( h ) : ( x ) ) ) 

/* 

External variables 

*/ 

/* Ordering table related variables */ 

GsOT WorldOT [ 2 ] ; 

GsOT_TAG OTTags [ 2 ] [ l«OT_LENGTH] ; 

/* Primitive related variables */ 

PACKET GpuPacketArea [2] [MAXOB J* ( 2 0+4 ) ] ; 

GsSPRITE sprt [MAXOBJ] ; 

/* Ball pattern movement related variables */ 
typedef struct { 



u_short x, y; 
u_short dx, dy; 

} POS; 

/* Controller related variables */ 
volatile u_char *bbO, *bbl; 

/* File reading related variables */ 
typedef struct { 

char *fname; 

void *addr; 

CdlFILE finfo; 

} FILE_INFO; 

static FILE_INFO dfile[DFILE] = { 

{ M \\DATA\\SOUND\\STDO.VH; 1" , (void * ) VH_ADDR, 0} f 
{ M \\DATA\\SOUND\\STDO.VB; 1" , (void *)VB_ADDR, 0} f 
{ " \ \ DATA\ \ SOUND\ \ SAMPLE1 . SEQ; 1 " , (void * ) SEQ_ADDR, 0}, 

}; 

/* Sound related variables */ 
short vab, seq; 

/* 

Static functions template 

*/ 

static void init_prim(); /* Ball pattern graphics related 

initialisation */ 

static void init_point ( POS *pos ) ; /* Ball pattern movement related 

initialisation */ 

static long pad_read ( long n); /* Controller state analysis */ 

static u_long PadRead(long id); /* Controller state reading */ 

static void dataf ile_search ( ) ; /* File retrieval on CD-ROM */ 

static void dataf ile_read () ; /* File reading on CD-ROM */ 

static void init_sound ( ) ; /* Sound data on memory playback 

preparation */ 

static void play_sound ( ) ; /* Sound playback start */ 

static void stop_sound ( ) ; /* Sound playback termination */ 


/* Location */ 
/* Speed */ 


/* 

Main functions 

*/ 



main ( ) 


{ 

int nobj = 1; 

( from 1 ) */ 

GsOT *ot ; 

int i, cnt, x, y; 

int activeBuff; 

GsSPRITE * sp; 

POS pos [MAXOBJ] ; 

POS *pp; 


/* Number of ball patterns displayed 

/* Pointer to drawing OT */ 

/* Working variables*/ 


SetVideoMode ( MODE_PAL ); /* 
/* SetVideoMode ( MODE_NTSC ); /* 

Get PadBuf ( &bbO , &bbl ) ; /* 
dataf ile_search ( ) ; /* 
dataf ile_read ( ) ; /* 


Gs I nit Graph (320, 240, 4, 0, 0); 

GsDef DispBuf f ( 0, 0, 0, 240); 

/* 

When drawing in ( 0, 0 ) - ( 320, 24 0 ) , 
When drawing in ( 0, 24 0 ) - ( 320, 4 80 
*/ 


PAL Mode */ 

NTSC Mode */ 

Get controller reception buffer */ 
Data file retrieval */ 

Data file reading */ 

/* Drawing and display 
environment setting */ 

/* Same as above */ 

display ( 0 , 24 0 ) - ( 320, 4 80 ) (db [ 0] ) 

, display (0, 0 ) - ( 320, 24 0 ) (db [ 0] ) 


/* Ordering table information setting */ 
for (i = 0; i < 2; 1++) { 

WorldOT [i] . length = OT_LENGTH; 

WorldOT [ i ] . org = OTTags[i]; 

} 

/* Font setting */ 

#ifdef KANJI /* In the case of Kanj i display */ 

Kanj iFntOpen (160, 16, 256, 240, 704, 0, 768, 256, 0, 512); 

#endif 

FntLoad(960, 256); 

/* Load basic font pattern in frame buffer */ 
FntOpen (16, 16, 256, 200, 0, 512); 

/* Font display location setting */ 

init_prim(); /* Primitive buffer initial setting */ 



init_point ( pos ) ; /* Ball pattern movement initial setting */ 

init_sound ( ) ; /* Sound initial setting */ 

play_sound ( ) ; /* Sound playback start */ 

/* Main loop */ 

while ( ( nob j = pad_read ( nobj ) ) >0) { 

/* Double buffer switch */ 
activeBuff = GsGetActiveBuf f ( ) ; 

GsSetWorkBase ( ( PACKET * ) GpuPacketArea [ activeBuff] ) ; 

/* Ordering table clear */ 

GsClearOt(0, 0, &WorldOT [ activeBuff ]) ; 

/* Ball pattern location update and registration to OT */ 
sp = sprt; pp = pos; 

for (i = 0; i < nobj; i++, sp++, pp++) { 

/* Horizontal coordinate value update */ 
if ( (x = (pp->x += pp->dx) % WALL_X*2) >= WALL_X) 
x = WALL_X* 2 - x; 

/* Vertical coordinate value update */ 
if ( (y = (pp->y += pp->dy) % WALL_Y*2) >= WALL_Y) 
y = WALL_Y* 2 - y; 

/* Set new coordinate value for sprite primitive */ 
sp->x = x; sp->y = y; 

/* Registration to sprite primitive ordering table */ 
GsSortFastSprite ( sp, &WorldOT [ activeBuff ] , 0); 

} 

DrawSync ( 0 ) ; /* Waiting for end of drawing */ 

cnt = VSync ( 0 ) ; /* Waiting for vertical synchronisation 

interrupt */ 

GsSwapDispBuf f ( ) ; /* Double buffer switching */ 

/* Registration to screen clear primitive ordering table */ 
GsSortClear ( 60, 120, 120, SWorldOT [ activeBuff ]) ; 

/* Drawing of primitive registered in OT */ 

GsDrawOt ( &WorldOT [ activeBuff ] ); 

/* Printing number of balls and elapsed time */ 



#ifdef KANJI 

Kanj i Fnt Print ( "Num =%d\n" , nobj ) ; 

Kanj i Fnt Print ( "Time =%d\n", cnt ) ; 

Kanj iFntFlush ( -1 ) ; 

#endif 

Fnt Print (" sprite = %d\n", nobj); 

Fnt Print ( "total time = %d\n\n\n" , cnt); 

FntPrint ( "UP : INCREASE\n" ) ; 

Fnt Print ( "DOWN : DECREASE\n" ) ; 

FntPrint ( "LI : PAUSE\n" ) ; 

FntPrint ( "SELECT: END\n" ) ; 

FntFlush ( -1 ) ; 

} /* Main loop terminal */ 

/* Execute this by pressing select button and verifying */ 
stop_sound ( ) ; /* Sound playback termination */ 

return ( 0 ) ; /* Program termination */ 

} 

/* 

Ball pattern initialisation 

*/ 

#include "balltex . h" /* Ball pattern texture pattern */ 

/* Ball pattern graphics related initialisation */ 
static void init_prim() 

{ 

Gs SPRITE * sp; 

u_short tpage; 

RECT rect; 

int i ; 

rect.x = 640; rect.y = 0; 
rect.w = 16/4; rect.h = 16; 

Loadlmage (&rect, balll6xl6); 
tpage = GetTPage(0, 0, 640, 0); 

for (i = 0; i < 32; i++) { 

rect.x = 0; rect.y = 480+i; 

rect.w = 256; rect.h = 1; 



Loadlmage ( &rect , ballcolor [ i ] ) ; 


} 

/* Sprite initialisation */ 

for (sp = sprt, i = 0; i < MAXOBJ; i++, sp++ ) { 

sp->attribute = 0; 
sp->x = 0; 
sp->y = 0; 
sp->w = 16; 

sp->h = 16; 

sp->tpage = tpage; 

sp->u = 0; 

sp->v = 0; 

sp->cx = 0; 

sp->cy = 480+ ( i%32 ) ; 

sp->r = sp->g = sp->b = 0x80; 

sp->mx = 0; 

sp->my = 0; 

sp->scalex = ONE; 

sp->scaley = ONE; 

sp->rotate = 0; 

} 

} 

/* Ball pattern movement related initialisation */ 
static void init_point ( POS *pos ) 


int 

for ( i 


= 0; i < MAXOBJ; i++) { 

pos->x = rand ( ) ; 

/* Start coordinate X */ 

pos->y = rand ( ) ; 

/* Start coordinate Y */ 
pos->dx = ( rand ( ) % 4) +1; 

/* Movement distance X l<=x<=4 ) */ 
pos->dy = ( rand ( ) % 4) +1; 

/* Movement distance Y l<=y<=4 ) */ 


} 



/* 

Reading and analysis of controller state 

*/ 

/* Analysis of controller state */ 

/* Return value 

-1 : At time of pressing select button and verifying 
1st argument + 4 : At time of pressing up button and verifying 
1st argument - 4 : At time of pressing down button and verifying 
Pause in function while pressing LI key */ 
static long pad_read ( long n) 

{ 

u_long padd = PadRead(l); /* Controller reading */ 

if (padd & PADLup ) n += 4; /* Left cross key up */ 

if (padd & PADLdown ) n -= 4; /* Left cross key down */ 

if (padd & PADL1 ) 

while ( PadRead ( 1 ) & PADL1 ) ; /* Pause */ 

if (padd & PADselect) 

return (-1); /* Program termination */ 

limitRange ( n, 1, MAXOB J-l ) ; /* n is given value l<=n<= (MAXOB J-l ) 

return ( n ) ; 

} 


/* Controller state reading */ 
static u_long PadRead (long id) 

{ 

return ( ~ ( * (bbO+3 ) | *(bb0+2) « 8 | *(bbl+3) « 16 | *(bbl+2) « 

24) ) ; 

} 

/* 

Reading the file on CD-ROM (DFILE) 

*/ 

/* Retrieving file on CD-ROM */ 
static void dataf ile_search ( ) 

{ 


int i r j ; 



for (i = 0; i < DFILE; i++) { /* Deal with DFILE file */ 

for (j = 0; j < 10; j ++ ) { /* Return loop */ 

if ( CdSearchFile ( & (df ile [ i ] . f info ) , df ile [ i ] . f name ) ! 

break; 

/* Retry loop interruption on normal termination */ 
else 


/* CD-ROM file reading */ 
static void dataf ile_read ( ) 


printf ( "%s not found . \n" , df ile [ i ] . fname ) ; 


int i , j ; 
int cnt; 


for (i = 0; i < DFILE; i++) { /* Deal with DFILE file */ 

for (j = 0; j < 10; j ++ ) { /* Retry loop */ 

CdReadFile ( df ile [ i ] . fname , df ile [ i ] . addr , df ile [ i ] .finfo.size); 

/* Normal processing can be executed by other side of read */ 

/* Here, remaining sector number is monitored until Read terminated */ 

while ((cnt = CdReadSync ( 1 , 0)) >0 ) 

VSync ( 0 ) ; /* Waiting for vertical 

synchronisation 
interrupt ( for time 
adjustment */ 


} 


if (cnt == 0) 

break; /* Retry loop interruption on normal 
termination* / 


/* 


Sound related 



/ 


/* Sound data on memory playback preparation */ 
static void init_sound ( ) 

{ 

/* VAB opening and transmission to sound buffer */ 

vab = SsVabTransf er ( ( u_char* ) VH_ADDR, ( u_char* ) VB_ADDR, -1, 1 ); 

if (vab < 0) { 

print f ( M SsVabTrans fer failed (%d)\n M , vab); 
return; 

} 

/* SEQ opening */ 

seg = SsSegOpen ( ( u_long * ) SEQ_ADDR, vab); 
if (seg < 0) 

print f ( M SsSegOpen failed (%d)\n", seg); 


/* Sound playback start */ 
static void play_sound() 

{ 

S s S e tMVo 1 ( MVOL , MVOL ) ; 

SsSegSetVol (seg, SVOL, SVOL); 
SsSegPlay (seg, S S PLAY_PLAY , SSPLAY 

} 

/* Sound playback termination */ 
static void stop_sound ( ) 

{ 

SsSegStop ( seg ) ; 

VSync ( 0) ; 

VSync ( 0) ; 

SsSegClose ( seg ) ; 

SsVabClose (vab) ; 

} 


/* Main volume setting*/ 

/* Volume setting for each SEQ */ 
INFINITY);/* Playback switch ON */ 


/* Playback switch OFF */ 

/* SEQ close */ 

/* VAB close */ 


/* Source code termination */ 




Additional Reading 


The following books may assist you to make NeYaroze applications. 

C Programming 


Title 

Publisher 

ISBN 

The C Programming Language 

Prentice Hall 

ISBN 0-13-110362-8 

Teach Yourself C 

McGraw-Hill 

ISBN 0-07-882011-1 

Programming with GNU Software 

O Reilly 

ISBN 0-56592-112-7 


Graphics 


Title 

Publisher 

ISBN 

3D Computer Graphics 

O Reilly 

ISBN 0-201-63186-5 

Encyclopedia of Graphic File 

Addison-W esley 

ISBN 1-56592-058-9 


Formats 
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